home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / qbbs / rlog_120.zip / REMOTLOG.DOC < prev    next >
Text File  |  1990-07-25  |  14KB  |  412 lines
  1.                                     
  2.  
  3.  
  4.  
  5.                          R E M O T E   A C C E S S
  6.  
  7.  
  8.                   L O G  R E P O R T I N G  P R O G R A M
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                                 REMOTLOG
  15.  
  16.    //////    /////  /      /  ///////  ///////   /        ///////  ///////
  17.    /     /   /      / /   //  /     /     /      /        /     /  /
  18.    //////    ///    /   /  /  /     /     /      /        /     /  /   ///
  19.    /     /   /      /      /  /     /     /      /        /     /  /     /
  20.    /      /  /////  /      /  ///////     /      ///////  ///////  ///////
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. The Program  - Remotlog
  68.  
  69.  
  70.         I developed Remotlog because when the announcement of RA was made and I
  71.         endeavored to switch from QuickBBS.  There was something missing.  I
  72.         could no longer use all my QBBS utilities.  After exhaustive efforts of
  73.         trying to get the implementation of my old program by its author, I
  74.         decided that it was time to do some coding.
  75.  
  76.         Here we have the finished product.  A full fledged RA log reporting
  77.         program.  This program is in no way crippled.  And never will be.
  78.  
  79.  
  80.  
  81.         RA is the registered product of Continental Software.
  82.         QuickBBS is the registered product of The QuickBBS Support Group.
  83.  
  84.  
  85.         At present this program will function with RA version 0.02.  It should
  86.         have no problems with 0.03 but will have to wait till its release.
  87.  
  88.         Do not attempt to use this program with any other software except RA
  89.         because it uses the file MESSAGES.RA.  If it cannot find this file the
  90.         program will abort in error.
  91.  
  92.         The screens provided by this program are as the author thought you
  93.         the sysops would like to see.  If you feel the information is too much
  94.         or that there is not enough, or would even like to see some of the
  95.         information moved from one location to another part of the page or a
  96.         totaly different screen.  Please do not hesitate to let the author
  97.         know.
  98.  
  99.  
  100.  
  101.  
  102. Configuration of Remotlog
  103.  
  104.         A copy of exactly how the configuration file looks is included with the
  105.         zipped package.  Here is a line by line definition.  The configuration
  106.         file is called REMOTLOG.CFG.
  107.  
  108.  
  109. ;-------------------------------------------------------------------------
  110. ;                       Remotlog Configuration file
  111. ;                        By Orland Carter 1:135/72
  112. ;-------------------------------------------------------------------------
  113. ;
  114. ;-------------------------------------------------------------------------
  115. ; This is a required entry.  It tells the program the [path + filename] of
  116. ; the Log file to be processed.
  117. ; DEFAULT : SYSTEM.LOG
  118. ;-------------------------------------------------------------------------
  119. ;
  120. LogFile SYSTEM.LOG
  121. ;
  122. ;-------------------------------------------------------------------------
  123. ; This option is required.  It tells the program what the Dos Shell entry
  124. ; of your External chat program is.  This must be the same case as the
  125. ; BBS writes it to the log file.  Required whether you have one or not.
  126. ; DEFAULT : FX-CHAT.EXE
  127. ;-------------------------------------------------------------------------
  128. ;
  129. ExternalChat FastChat.EXE
  130. ;
  131. ;-------------------------------------------------------------------------
  132. ; This option is required.  It tells the program what [path + filename]
  133. ; the output of the program should be placed in. *.asc/*.ans versions.
  134. ; DEFAULT : REMOTLOG
  135. ;-------------------------------------------------------------------------
  136. ;
  137. Outputfile c:\RA\Txt\Remotlog
  138. ;
  139. ;-------------------------------------------------------------------------
  140. ; This option is required.  It tells the program which color to place the
  141. ; background of the ansi screen in.
  142. ; DEFAULT : 40
  143. ;-------------------------------------------------------------------------
  144. ;
  145. Back 40
  146. ;
  147. ;-------------------------------------------------------------------------
  148. ; This option is required.  It tells the program what color the numbers
  149. ; displayed are.
  150. ; DEFAULT : 1;33
  151. ;-------------------------------------------------------------------------
  152. ;
  153. Numbers 1;33
  154. ;
  155. ;-------------------------------------------------------------------------
  156. ; This option is required.  It tells the program what color to use when
  157. ; highlighting the Beginning and Ending dates of the Log period.
  158. ; DEFAULT : 1;46;37
  159. ;-------------------------------------------------------------------------
  160. ;
  161. HighLight 1;46;37
  162. ;
  163. ;-------------------------------------------------------------------------
  164. ; This option is required.  It tells the program which color to use to
  165. ; restore the screen to "normal".
  166. ; DEFAULT : 0
  167. ;-------------------------------------------------------------------------
  168. ;
  169. Normal 0
  170. ;
  171. ;-------------------------------------------------------------------------
  172. ; This option is required.  It tells the program which color to use for
  173. ; Outlining the Box and Dividing lines of the output file.
  174. ; DEFAULT 1;34
  175. ;-------------------------------------------------------------------------
  176. ;
  177. Outline 1;34
  178. ;
  179. ;-------------------------------------------------------------------------
  180. ; This option is required.  It tells the program which color to use for
  181. ; all the text that is printed.
  182. ; DEFAULT 0;32
  183. ;-------------------------------------------------------------------------
  184. ;
  185. Text 0;32
  186. ;
  187. ;-------------------------------------------------------------------------
  188. ; This option is required.  It tells the program whether or not you wish
  189. ; the optional page of Multiline usage to be displayed.  The statistics
  190. ; will still be stored if the option is not selected.
  191. ; DEFAULT : NOMULTILINE
  192. ;-------------------------------------------------------------------------
  193. ;
  194. NoMultiLine
  195. ;
  196. ;-------------------------------------------------------------------------
  197. ; This option is required.  It telss the program what type of log file
  198. ; You are using.  Wheter FD [Front Door type] or OPUS.
  199. ; DEFAULT FD
  200. ;-------------------------------------------------------------------------
  201. ;
  202. FD
  203. ;
  204. ;-------------------------------------------------------------------------
  205. ; This option is not required and at the descretion of the sysop.  Using
  206. ; This will cause another page to be displayed in addition to the current
  207. ; 2 or 3 pages that are already displayed.  This option is where the sysop
  208. ; Can have remotlog search the logfile for something specific and keep
  209. ; track of its occurrences.
  210. ; I.e. *01My_Name Carter      - This will cause remotlog to search the log
  211. ; file for all occurences of "Carter" it will accumulate and store the
  212. ; amount of time it finds it in variable 01.  When it displays it it will
  213. ; display "My_Name >>> ####" where # is amount of times the item was found
  214. ; Possible Variables are 00-10.  The 0 is significant.  The "*" is required
  215. ; There can be no spaces except to separate the Display item from the
  216. ; Search item.
  217. ; Format "*<Variable 00-10><Entry to Make in *.Ans/*.Asc file> <Search For>"
  218. ;         *00My_Name Carter
  219. ;-------------------------------------------------------------------------
  220. ;
  221. ;*00My_Last_Name  Carter
  222. ;*01My_First_Name Orland
  223. ;
  224. ;-------------------------------------------------------------------------
  225. ; These options are not required.  But they do provide you with a great
  226. ; amount of security.  For areas you do not want all your users to see.
  227. ; IE. Adult areas or Sysop areas.
  228. ; DEFAULT - NONE.  200 MAXIMUM ENTRIES.
  229. ;-------------------------------------------------------------------------
  230. ;
  231. NoShow  8
  232. NoShow 10
  233. NoShow 12
  234. NoShow 19
  235. NoShow 36
  236. NoShow 45
  237. NoShow 49
  238. NoShow 50
  239. NoShow 51
  240. ;
  241. ;-------------------------------------------------------------------------
  242. ; This option is not required.  It is used to Change the default Sealink
  243. ; protocol displayed in the 1st output page to a protocol of your choosing.
  244. ; REPLACESEA - Is the Search String for the new protocol.
  245. ; REPLACEDSP - Is the Actual Item to be displayed in the Output page.
  246. ;-------------------------------------------------------------------------
  247. ;
  248. ;ReplaceSea SEALink
  249. ;ReplaceDsp SEALink
  250. ;
  251. ;-------------------------------------------------------------------------
  252. ; This option is also not required.  It determines whether or not the local
  253. ; logons will be shown on the report output.  The default for this option
  254. ; is show local logons.  Leave this option out for the default to take
  255. ; effect.
  256. ;-------------------------------------------------------------------------
  257. ;
  258. ;NoLocal
  259. ;
  260. ;-------------------------------------------------------------------------
  261. ; This option is also not required.  It activates or deactivates the
  262. ; Files.BBS downloaded files counter.  The count will be stored and added
  263. ; to the Files.BBS in the directory the file was taken from.  Default for
  264. ; This option is FILECOUNTER,     To deactivate use NOFILECOUNT
  265. ;-------------------------------------------------------------------------
  266. ;
  267. FILECOUNTER
  268. ;
  269. ;-------------------------------------------------------------------------
  270. ; This option is also not required.  It activates a chat record.  This will
  271. ; log all chats found in the log file to a file called REMOTLOG.CHT in the
  272. ; current directory.  The default is CHATRECORD, all chats will be logged.
  273. ; The other option to disable the chat is NOCHATRECORD
  274. ;-------------------------------------------------------------------------
  275. ;
  276. CHATRECORD
  277. ;
  278. ;-------------------------------------------------------------------------
  279. ; This option is also not required.  It activates or Deactivates the log
  280. ; deleting option.  The Default is the log will be deleted every 10 days.
  281. ; The two options are DELTELOG ## (Where ## is days log should be kept.)
  282. ; and NODELETELOG.
  283. ;-------------------------------------------------------------------------
  284. ;
  285. DELETELOG 10
  286. ;
  287. ;-------------------------------------------------------------------------
  288. ;          E N D    O F    R E M O T L O G . C F G   F I L E
  289. ;-------------------------------------------------------------------------
  290.  
  291. --------- End Of Configuration Section ----------
  292.  
  293. Here is a quick Batch file example to demonstrate the use of the Chat logging
  294. feature.
  295.  
  296. Batch File .........
  297. Echo make master Directory
  298.      REMOTLOG
  299.      Mbutil Post Remotlog.Cht #28 -To "Orland Carter" -From "Remotlog" -Subject "Chat Requests"
  300.      Del Remotlog.cht
  301.      MSTRDIR
  302.      ren mstrdir.cfg *.tmp
  303.      ren mstrdir.g   *.cfg
  304.      MSTRDIR
  305.      ren mstrdir.cfg *.g
  306.      ren mstrdir.tmp *.cfg
  307. End Of Batch File....................
  308.  
  309.  
  310.  
  311.  
  312.  
  313. Supplied ANSI Code sequences
  314.  
  315. Number  Represents
  316. ------  ----------
  317. 0       All attributes off  (Normal Display)
  318.  
  319. 1       High Intensity (Bold)
  320.  
  321. 5       Sets Blink on
  322.  
  323. 7       Reverse Video on
  324.  
  325. 8       Concealed on (makes display invisible)
  326.  
  327. 30      Foreground      Black
  328.  
  329. 31                      Red
  330.  
  331. 32                      Green
  332.  
  333. 33                      Yellow
  334.  
  335. 34                      Blue on Color Monitor
  336.                         Underline on MonoChrome
  337.  
  338. 35                      Magenta
  339.  
  340. 36                      Cyan
  341.  
  342. 37                      White
  343.  
  344. 40      BackGround      Black
  345.  
  346. 41                      Red
  347.  
  348. 42                      Green
  349.  
  350. 43                      Yellow
  351.  
  352. 44                      Blue
  353.  
  354. 45                      Magenta
  355.  
  356. 46                      Cyan
  357.  
  358. 47                      White
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365. Hints about operation of this program
  366.  
  367.   There are several different things that you can do to get certain results
  368.   from this program.
  369.  
  370.    For example if you want to change the beging date of the report without
  371.    erasing the remotlog.dat file.  All you have to do is to edit the .DAT file
  372.    find the string that has the date in it and make it a null string.  When the
  373.    program starts up it will notice the date is missing and get the date from
  374.    the current system.log file.
  375.  
  376.    When reading the log file the program will not attempt to reposition pointers
  377.    if the last item in the log is that REMOTLOG has checked the log.  Of course
  378.    the current session will be appended to the end of the logfile.
  379.  
  380.    By deleting the notations that REMOTLOG makes in the log file you can force
  381.    it to re-process the log file.
  382.  
  383.    Any bug reports, comments, or requested addition, deletions etc. may be sent
  384.    to Node 1:135/72.  or the address listed in the donations section.  I can
  385.    also be reached in the RA_SUPPORT echo.
  386.  
  387.  
  388.  
  389. Credits
  390.  
  391.    The author, Orland K. Carter, would like to thank my beta testers of
  392.    this program that put up with the constant updates to the one program and
  393.    major overhaul of their configuration and data files.
  394.  
  395.    Daniel Johnston, and Robert Taylor, Peter Janssens thank you for your
  396.    patience, and help in beta testing this program.
  397.  
  398.  
  399. Donations
  400.  
  401.    A donation if you wish can be made to the author.
  402.  ____________________________________________________________________________
  403. |Make all donations address to                                               |
  404. |  Orland K. Carter, REMOTLOG                                                |
  405. |  2850 N.W. 155 Terrace                                                     |
  406. |  Opa-Locka, FL  33054-2223                                                 |
  407. |____________________________________________________________________________|
  408.  
  409. Thank you for your support.
  410.  
  411.         Orland
  412.